home *** CD-ROM | disk | FTP | other *** search
/ Amiga Developer CD 2.1 / Amiga Developer CD v2.1.iso / Contributions / Haage_&_Partner / Storm-Projects / NDKExamples1 / PCMCIA / AmigaXIP / AmigaXIP.ReadMe < prev    next >
Encoding:
Text File  |  1999-04-16  |  3.5 KB  |  80 lines
  1. PCMCIA AmigaXIP Execute-in-place code
  2. =====================================
  3.  
  4. (c) Copyright 1991-1996 Amiga International, Inc. All rights reserved.
  5. Preliminary
  6.  
  7.    THIS SOFTWARE AND INFORMATION IS COPYRIGHTED.
  8.  
  9.    THIS SOFTWARE AND INFORMATION MAY NOT BE REDISTRIBUTED, DISCLOSED,
  10.    OR DUPLICATED, IN WHOLE OR IN PART, IN ANY MANNER OTHER THAN AS
  11.    SPECIFIED IN A SIGNED AGREEMENT WITH Amiga International, Inc.
  12.  
  13.  *************************************************************************
  14.  *                                                                       *
  15.  *                             DISCLAIMER                                *
  16.  *                                                                       *
  17.  *    THIS SOFTWARE/INFORMATION IS PROVIDED "AS IS".                     *
  18.  *    NO REPRESENTATIONS OR WARRANTIES ARE MADE WITH RESPECT TO THE      *
  19.  *    ACCURACY, RELIABILITY, PERFORMANCE, CURRENTNESS, OR OPERATION      *
  20.  *    OF THIS SOFTWARE/INFORMATION, AND ALL USE IS AT YOUR OWN RISK.     *
  21.  *    NEITHER AMIGA INTERNATIONAL INC. NOR THE AUTHORS ASSUME ANY        *
  22.  *    RESPONSIBILITY OR LIABILITY WHATSOEVER WITH RESPECT TO YOUR        *
  23.  *    USE OF THIS SOFTWARE/INFORMATION.                                  *
  24.  *                                                                       *
  25.  *************************************************************************
  26.  
  27. loadc
  28. xipcode.asm
  29. loadseg.asm
  30.  
  31. Xipcode.asm is a minimal example of Amiga execute-in-place code for PCMCIA.
  32. The code contains a RomTag (struct Resident) and is assembled into
  33. an Amiga load file.
  34.  
  35. The loadc command can be used to loadseg "xipcode" to a not-in-use RAM
  36. credit card.  To do this you should boot without the RAM card,
  37. then use the PrepCard tool to format the card as system RAM.
  38.  
  39. Then do
  40.  
  41.     loadc xipcode
  42.  
  43. Loadc will add the appropriate PCMCIA tuples to identify the code
  44. as AmigaXIP (execute-in-place) code.  The system will InitResident the
  45. RomTag when you reboot the system.  The RomTag will be initialized right
  46. before strap (ie. all of the system will be up and running EXCEPT
  47. for intuition and dos).  Your code can open intuition, as shown in
  48. the example.
  49.  
  50. In the example xipcode.asm, if you press the left mousebutton on the demo
  51. screen, it will exit and the system will continue with the strap process
  52. (ie. system will attempt to boot from a bootable hard disk or floppy).
  53. A game, for example, might instead never return.
  54.  
  55. A value of TRUE (1) returned by AmigaXIP code signifies that the card is
  56. not removable (i.e. the card is in use, and system should be reset if the
  57. card is removed).  A value of FALSE (0) signifies that the card IS removable.
  58. If your AmigaXIP code exits, be sure to return the value 1 if the code
  59. or data in your card is still in use.
  60.  
  61. The "xipcode" program is linked with NO startup.asm code
  62. (blink from xipcode.o to xipcode library lib:amiga.lib), and is written
  63. so that it does not write to any variables in data or code space.
  64. This code could therefore run out of RAM or directly out of ROM.  If you
  65. need to loadseg your own code into system RAM in order to run, use the
  66. provided loadseg.asm code as an example of how to loadseg yourself.
  67.  
  68. Note that if a non-harddisk machine is turned on with no bootable
  69. disk or card inserted, any of the following can be inserted to
  70. satisfy the request for a boot disk:
  71.  
  72.     - bootable (installed) floppy
  73.     - AmigaXIP credit card
  74.     - bootable Amiga-disk credit card (use PrepCard and new
  75.         Install command provided on this disk)
  76.  
  77.  
  78. For more information on AmigaXIP and alternatives for PCMCIA code, read
  79. the PCMCIA.Software readme.
  80.